home *** CD-ROM | disk | FTP | other *** search
/ Aminet 30 / Aminet 30 (1999)(Schatztruhe)[!][Apr 1999].iso / Aminet / mus / misc / play_handler_s.lzh / play-handler / PLAY-Handler.dok < prev    next >
Text File  |  1999-01-11  |  3KB  |  58 lines
  1.  
  2.                 PLAY-Handler  Doku
  3.  
  4.  
  5. Dieses Program war Shareware. Aufgrund der unglaublichen Nachfrage (so ca. 0)
  6. und der Tatsache, dass es mittlerweiler reichlich alt ist, habe ich mich
  7. entschlossen, das Program unter die Gnu Public License (GPL) zu stellen. Diese
  8. ist im selben Vverzeichnis zu finden unter dem namen COPYING.
  9.  
  10. Installation:
  11. Diese beschraenkt sich auf ein Minimum. Man kann das Installationsskript
  12. benutzen, oder von Hand play-handler nach l: kopieren, und anschliessend
  13. PLAY und PLAY.info nach devs:dosdrivers bzw. mountlist.play an
  14. devs:mountlist anhaengen. Anschliessend kann man den Handler mit mount
  15. play: starten.
  16.  
  17. Benutzung:
  18. Play: bietet ein Interface zum Audio.device fuer fertige Samples (raw oder
  19. 8SVX=Iff) an. Es ist ein Stream-Handler, der nur beschrieben werden kann.
  20. (Das Mikrophon ist noch nicht im Amiga eingebaut. ;-)) Man oeffnet "play:"
  21. als normale Datei und schreibt rein, was man hoeren will, am einfachsten
  22. mit copy <sample> play:. (Vorsicht: Je nach Groesse des Samples und dem
  23. Max-Transfer Wert des Dateisystems kann der Speicher knapp werden).
  24. Von type <sample> to play: ist abzuraten. Erstens veraendert type
  25. nichtdruckbare Zeichen, und zweitens kopiert es daten 196-byte-weise,
  26. was ein bisschen langsam ist. Join dagegen funktioniert einwandfrei.
  27. Wenn man play: mit zu kleinen Haeppchen (unter 256 Byte) fuettert, kann
  28. es sein, dass der Ton aussetzt, da play: nicht schnell genug neue
  29. Sounddaten bekommt. Die Samples werden im Double-Buffering-Verfahren
  30. abgespielt, so dass bei kontinuierlicher Eingabe ununterbrochen was
  31. aus dem Lautsprecher kommt.
  32. Die Zahl der internen 512-Byte Puffern kann man mit dem Addbuffers-Befehl
  33. ansehen und aendern.
  34. Ueber den Dateinamen kann man das Verhalten von play: beeinflussen.
  35. play: oeffnet einen Monokanal und hat fuer Raw-Samples die Voreinstellung
  36.     8192 Samples/Sekunde. (Iff-Samples werden mit ihren eigenen
  37.     Sampling-Rate abgespielt.)
  38. play:s spielt das Sample ueber einen Stereaokanal. (links wie rechts
  39.     dasselbe)
  40. play:l spielt nur links
  41. play:r spielt nur rechts
  42. play:<zahl> spielt das Sample (auch Iff-Samples) mit <zahl> Samples/Sekunde ab.
  43.  
  44. Beides kann kombiniert werden, wobei der Buchstabe vor der Zahl kommen
  45. muss. Beispiel: play:s10000 spielt das Sample in Stereo mit 10000 Samples
  46. pro Sekunde ab. Vorsicht: Die Samplingrate wird nicht ueberprueft. Extreme
  47. Werte koennen merkwuerdige Ergebnisse liefern.
  48. Play: kann mehrfach geoeffnet werden, solange Speicher und Soundkanaele da
  49. sind, so das mehere Samples gleichzeitig gespielt werden.
  50.  
  51. Ach ja, es sollte unter allen OS-Versionen laufen. (getestet mit V3.0)
  52.  
  53. Fehler (uhh), Vorschlaege und sonstige Rueckmeldungen sind herzlich
  54. wilkommen. Ansonsten viel Spass beim ausprobieren
  55.  
  56. Joerg
  57.  
  58.